Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Defining Your Own User Pane Functions

This section describes the application-defined user pane functions that provide you with the ability to create a custom Appearance-compliant control without writing your own control definition function. A user pane is a general purpose stub control; it can be used as the root control for a window, as well as providing a way to hook in application-defined functions such as those described below. When Appearance is available, user panes should be used in dialog boxes instead of user items.

Once you have provided a user pane application-defined function, pass the tag constant representing the user pane function you wish to get or set in the tagName parameter of SetControlData. For a description of the tag constants, see "Control Data Tag Constants". For example, to set a user pane draw function, pass the constant kControlUserPaneDrawProcTag of type ControlUserPaneDrawingUPP in the tagName parameter of SetControlData.The Control Manager then draws the control using a universal procedure pointer to your user pane draw function.